home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / asm / fdtools11.lha / FDTools.doc < prev    next >
Encoding:
Text File  |  1994-06-27  |  1.6 KB  |  60 lines
  1. FDTools, V1.1
  2.  
  3. 1. What is this ?
  4.  
  5. FDTools is a package of three small programs that handle .fd (shared
  6. library description) files:
  7.  
  8.   - fd2i: FDFILE/A,IFILE/A
  9.  
  10.     fd2i converts a .fd file into an assembler include file (.i) containing
  11.     the LVO values for the library.
  12.  
  13.   - fd2stub: FDFILE/A,STUBFILE/A
  14.  
  15.     fd2stub creates an assembler (.a) file containing the LVOs and stub
  16.     function calls - including stubs for easy varargs usage.
  17.  
  18.   - fd2pragma: FDFILE/A,INCFILE/A
  19.  
  20.     fd2pragma is a replacement for the SAS/C utility fd2pragma. My fd2pragma
  21.     is able to generate #pragma tagcall statements correctly !
  22.  
  23. 2. Varargs detection
  24.  
  25. The .fd tools are able to detect functions with varargs (e.g. taglists)
  26. if they follow the naming convention:
  27.  
  28.   - Function names of the form xxxA() (exceptions: Cache(Pre|Post)DMA()) and 
  29.     yyyTagList() indicate varargs.
  30.  
  31.   - The respective stubs/tagcalls are xxx() and yyyTags().
  32.  
  33.   - In addition to that yyyTagList() has a (non varargs) alias yyy()
  34.     (exceptions: Open(Window|Screen)TagList).
  35.  
  36.   - Any function whose last parameter is called "taglist" or "tags" but
  37.     whose name does not end with "A" or "TagList" is handled like a 
  38.     yyyTagList() type funtion.
  39.  
  40.   - The functions VFWritef, VFPrintf and VPrintf have varargs stubs without
  41.     the leading "V".
  42.  
  43. 3. Legal stuff
  44.  
  45. FDTools is freeware. There is *absolutely no warranty*.
  46.  
  47. 4. Bug reports
  48.  
  49. Send bug reports, suggestions, flames et al. to
  50.  
  51. Usenet:       nobbi@zaphod.rhein.de
  52. Fidonet:      2:2453/30.14
  53. Gernet:       21:100/50.14 
  54.  
  55. 5. History
  56.  
  57. 1.0 - first public release
  58.  
  59. 1.1 - Made the fd-file parsing routine more tolerant.
  60.